home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zggbak.z / zggbak
Text File  |  1996-03-14  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZGGGGGGGGBBBBAAAAKKKK((((3333FFFF))))                                                          ZZZZGGGGGGGGBBBBAAAAKKKK((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZGGBAK - form the right or left eigenvectors of a complex generalized
  10.      eigenvalue problem A*x = lambda*B*x, by backward transformation on the
  11.      computed eigenvectors of the balanced pair of matrices output by ZGGBAL
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE ZGGBAK( JOB, SIDE, N, ILO, IHI, LSCALE, RSCALE, M, V, LDV,
  15.                         INFO )
  16.  
  17.          CHARACTER      JOB, SIDE
  18.  
  19.          INTEGER        IHI, ILO, INFO, LDV, M, N
  20.  
  21.          DOUBLE         PRECISION LSCALE( * ), RSCALE( * )
  22.  
  23.          COMPLEX*16     V( LDV, * )
  24.  
  25. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  26.      ZGGBAK forms the right or left eigenvectors of a complex generalized
  27.      eigenvalue problem A*x = lambda*B*x, by backward transformation on the
  28.      computed eigenvectors of the balanced pair of matrices output by ZGGBAL.
  29.  
  30.  
  31. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.      JOB     (input) CHARACTER*1
  33.              Specifies the type of backward transformation required:
  34.              = 'N':  do nothing, return immediately;
  35.              = 'P':  do backward transformation for permutation only;
  36.              = 'S':  do backward transformation for scaling only;
  37.              = 'B':  do backward transformations for both permutation and
  38.              scaling.  JOB must be the same as the argument JOB supplied to
  39.              ZGGBAL.
  40.  
  41.      SIDE    (input) CHARACTER*1
  42.              = 'R':  V contains right eigenvectors;
  43.              = 'L':  V contains left eigenvectors.
  44.  
  45.      N       (input) INTEGER
  46.              The number of rows of the matrix V.  N >= 0.
  47.  
  48.      ILO     (input) INTEGER
  49.              IHI     (input) INTEGER The integers ILO and IHI determined by
  50.              ZGGBAL.  1 <= ILO <= IHI <= N, if N > 0; ILO=1 and IHI=0, if N=0.
  51.  
  52.      LSCALE  (input) DOUBLE PRECISION array, dimension (N)
  53.              Details of the permutations and/or scaling factors applied to the
  54.              left side of A and B, as returned by ZGGBAL.
  55.  
  56.      RSCALE  (input) DOUBLE PRECISION array, dimension (N)
  57.              Details of the permutations and/or scaling factors applied to the
  58.              right side of A and B, as returned by ZGGBAL.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZGGGGGGGGBBBBAAAAKKKK((((3333FFFF))))                                                          ZZZZGGGGGGGGBBBBAAAAKKKK((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      M       (input) INTEGER
  75.              The number of columns of the matrix V.  M >= 0.
  76.  
  77.      V       (input/output) COMPLEX*16 array, dimension (LDV,M)
  78.              On entry, the matrix of right or left eigenvectors to be
  79.              transformed, as returned by ZTGEVC.  On exit, V is overwritten by
  80.              the transformed eigenvectors.
  81.  
  82.      LDV     (input) INTEGER
  83.              The leading dimension of the matrix V. LDV >= max(1,N).
  84.  
  85.      INFO    (output) INTEGER
  86.              = 0:  successful exit.
  87.              < 0:  if INFO = -i, the i-th argument had an illegal value.
  88.  
  89. FFFFUUUURRRRTTTTHHHHEEEERRRR DDDDEEEETTTTAAAAIIIILLLLSSSS
  90.      See R.C. Ward, Balancing the generalized eigenvalue problem,
  91.                     SIAM J. Sci. Stat. Comp. 2 (1981), 141-152.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.